home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / listshow.zip / SHOW2.DOC < prev    next >
Text File  |  1991-06-01  |  25KB  |  586 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                                                        │
  17.                                                       The Silicon Frog │
  18.                                                                        │
  19.                                                      The SHOW2 Program │
  20.                                                                        │
  21.                                                 FirsLook's Show Viewer │
  22.                                                                        │
  23.                                                            Version 2.0 │
  24.                                                                        │
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.             Copyright (c) 1991, The Silicon Frog, Inc.
  58.                           All Rights Reserved
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.             Introduction...............................................3
  66.               Quick Start..............................................3
  67.               Starting SHOW2 in Manual Mode............................3
  68.                 The Show File Menu.....................................5
  69.                 The Credit Screen......................................5
  70.               Running SHOW2 - Manual Mode..............................5
  71.                 F2 - Screen Menu.......................................6
  72.                 F3 - Special Effects Toggle............................6
  73.                 First and Last Screens.................................7
  74.               AutoMode Operation.......................................7
  75.                 No-Show Files..........................................7
  76.               Starting and Running SHOW2 in AutoMode...................7
  77.                 AutoMode/Manual Mode Toggle............................8
  78.                 AutoMode Batch Operation...............................8
  79.                 Continuous Unattended Operation........................9
  80.               Video Adapter Support....................................9
  81.                 Incompatible Video Adapters...........................10
  82.               Compatibility with earlier versions.....................10
  83.               SHOW - Version History..................................11
  84.                 Version 2.0...........................................11
  85.                 Version 1.7...........................................11
  86.                 Version 1.6...........................................11
  87.                 Version 1.5...........................................11
  88.                 Versions 1.0 through 1.4..............................11
  89.  
  90.  
  91.  
  92.                                                                  SHOW2 3
  93.  
  94.  
  95.             Introduction
  96.  
  97.             The SHOW2 program displays Show Files (.SH2) created with
  98.             the FirstLook system.  SHOW2 requires approximately 90K to
  99.             operate, and PC- or MS-DOS release 2.1 or greater.  A color
  100.             display is highly recommended, but not mandatory.  SHOW2
  101.             also takes advantage of a Microsoft or compatible mouse if
  102.             one is available.
  103.  
  104.  
  105.             Quick Start
  106.  
  107.             For experienced folks and all who hate to read .DOCs, here's
  108.             the quickest way to view shows with the SHOW2 program:
  109.  
  110.             1. Copy SHOW2.EXE and all .SH2 show files to the same
  111.                diskette or hard disk directory,
  112.  
  113.             2. At the DOS prompt, type SHOW2 and press <Enter>
  114.  
  115.             3. Follow the program's instructions.  When viewing the
  116.                show, press F1 to toggle the help line ON/OFF.
  117.  
  118.  
  119.             Starting SHOW2 in Manual Mode
  120.  
  121.             SHOW2's manual mode is intended for personal show viewing
  122.             (the program's automated mode is used for unattended show
  123.             displays).  To start SHOW2 in manual mode, use the following
  124.             command:
  125.  
  126.             SHOW2 [SHOWDIR] [/BWx] [/NOFX] [/NH]
  127.  
  128.             [SHOWDIR] is an optional parameter which points to the
  129.             directory where the desired Show Files (.SH2) are stored.
  130.             SHOWDIR must be a valid DOS drive:\directory\ name
  131.             containing a trailing backslash.  If the [SHOWDIR] parameter
  132.             is omitted, SHOW2 will look for .SH2 files in the current
  133.             directory.  If the SHOW2 program is in directory in your DOS
  134.             PATH, start the SHOW2 program from the .SH2 file directory
  135.             and omit the [SHOWDIR] parameter.
  136.  
  137.             The [/BWx] optional parameter forces monochrome display and
  138.             color translation modes (new in SHOW 1.6) in cases where
  139.             SHOW2 is unable to automatically detect a monochrome
  140.             monitor, or whenever the default color translation does not
  141.             yield acceptable results on your monochrome monitor.  See
  142.             the section titled "Video Adapter Support" later on this
  143.             document for additional information on supported displays.
  144.  
  145.  
  146.  
  147.                                                                  SHOW2 4
  148.  
  149.  
  150.             The [/NH] parameter is intended specifically for display
  151.             adapters which are not fully compatible with the IBM
  152.             standards.  These include monochrome adapters (MDA, Hercules
  153.             or compatibles) and color/graphics adapters (CGA, EGA, VGA
  154.             and MCGA).  If your monitor exhibits erratic behavior,
  155.             displays garbage, or if your computer locks up for no
  156.             apparent reason, use the /NH parameter on the SHOW2 command
  157.             line.  Read the paragraph titled "Video Adapter Support"
  158.             later in this document for additional details.
  159.  
  160.             Following are sample commands:
  161.  
  162.             1. Show Files are in C:\DATA\SHOWS, SHOW2 is in C:\SHOW
  163.  
  164.             C:>CD SHOW
  165.             C:>SHOW2 C:\DATA\SHOWS\ <Enter>
  166.  
  167.             2. The SHOW2 program is in the DOS PATH and Show Files are
  168.                in the C:\DATA\SHOW directory:
  169.  
  170.             C:>CD DATA\SHOW
  171.             C:>SHOW2 <Enter>
  172.  
  173.             3. SHOW2.EXE and Show files are in the current directory and
  174.                monochrome output with default color translation is
  175.                desired:
  176.  
  177.             C:>SHOW2 /BW1 <Enter>
  178.  
  179.             The /NOFX parameter, if specified, disables special screen
  180.             transition effects, if any.  Screen effects and screen
  181.             display timing for AutoMode are defined by the show's
  182.             author.  If the show contains special effects, they are
  183.             displayed by default.  If /NOFX is specified, it can be
  184.             overridden during the show (in manual mode) by pressing the
  185.             F3 key.
  186.  
  187.             Program startup
  188.  
  189.             If no Show Files were found in the current directory or in
  190.             the directory specified on the command line, SHOW2 will
  191.             terminate with an appropriate error message.  The error
  192.             message may also be displayed if an incorrect command-line
  193.             parameter was used.
  194.  
  195.             If .SH2 files were found, SHOW2 will display its
  196.             logo/copyright screen.  The logo screen will scroll away,
  197.             and will be replaced by an informational screen about
  198.             SHOW2's Help Line.  Since most screens contain 25 lines'
  199.             worth of information, the Help Line is not displayed by
  200.  
  201.  
  202.  
  203.                                                                  SHOW2 5
  204.  
  205.  
  206.             default.  To proceed with the Show File Menu Screen, press
  207.             any key or click any mouse button.
  208.  
  209.             The Show File Menu
  210.  
  211.             The Show File Menu Screen displays a variable-size,
  212.             scrollable window containing the titles of all shows found
  213.             in the show directory.  To select a show, use the cursor
  214.             key(s) or roll the mouse until the desired show name is
  215.             highlighted, then press <Enter> or click the left mouse
  216.             button.  Pressing <Esc> or clicking the right mouse button
  217.             exits SHOW2 and returns to DOS.
  218.  
  219.             The Credit Screen
  220.  
  221.             Once you have selected a Show,  a credit screen will be
  222.             shown for a few short seconds, acknowledging the show's
  223.             author.  You will then be prompted to press any key or click
  224.             either mouse button to start the Show.  In AutoMode, the
  225.             credit screen display may be disabled with the /NOA command-
  226.             line parameter.
  227.             Running SHOW2 - Manual Mode
  228.  
  229.             When SHOW2 starts, it immediately displays the first screen
  230.             in the .SH2 file.  Pressing the F1 keys cycles help
  231.             information on the screen's 25th line.  The default Help
  232.             Line displays keyboard help;  the second help line displays
  233.             mouse help.  Pressing F1 a third time erases the help line
  234.             so that all screen data is visible.  Since many screens
  235.             contain 25 lines' worth of information, keeping the help
  236.             line off will allow you to view the entire screen.  Once you
  237.             become familiar with SHOW2's simple commands, you will want
  238.             to keep the help line OFF permanently.
  239.  
  240.             SHOW2 controls are simple and intuitive:
  241.  
  242.                                F1 - Cycle Help Line (kb/mouse/OFF)
  243.                                F2 - Show Screen Menu
  244.                                F3 - Special Effects Toggle
  245.                   PgDn/Click Left - Display Next Screen
  246.                  PgUp/Click Right - Display Previous Screen
  247.                              Home - Display First Screen
  248.                               End - Display Last Screen
  249.                     F2/Click Both - Screen Menu
  250.                               Esc - Exit Show/Return to Show File Menu
  251.  
  252.  
  253.  
  254.                                                                  SHOW2 6
  255.  
  256.  
  257.             In addition to the PgUp and PgDn keys, SHOW2 also responds
  258.             to the following keys to move from screen to screen:
  259.  
  260.                       Next Screen - Space Bar, Plus or Equal keys,
  261.                                     <Enter>, Tab (-->|), Down Arrow
  262.                                     and Insert key.
  263.                   Previous Screen - Minus keys, Backspace key, Up Arrow,
  264.                                     Shift-Tab, and Delete key.
  265.  
  266.             When you exit the Show, the Show File Menu Screen will be
  267.             re-displayed.
  268.  
  269.             F2 - Screen Menu
  270.  
  271.             Pressing F2 (or clicking both mouse buttons) at any time
  272.             during the show displays the Show's Screen Menu.  The top
  273.             line of the menu screen contains the Show's title.  Below
  274.             the title, a scrollable window displays the show's screen
  275.             descriptions and allows selection of the next screen to be
  276.             viewed.
  277.  
  278.             While in the screen selection window, the following keys and
  279.             key combinations are active:
  280.  
  281.                     Dn/Mouse Down - Down one screen
  282.                       Up/Mouse Up - Up one screen
  283.                              PgDn - Down 18 screens
  284.                              PgUp - Up 18 screens
  285.                              Home - Top of Window
  286.                               End - Bottom of Window
  287.                             ^Home - First Screen
  288.                              ^End - Last Screen
  289.                  Enter/Click Left - Select screen and exit
  290.                   Esc/Click Right - Exit without screen change
  291.  
  292.             Pressing <Enter> or clicking the left mouse button selects
  293.             the highlighted screen and resumes the show at the new
  294.             starting location.
  295.  
  296.             Pressing <Esc> or clicking the right mouse button returns to
  297.             the show where you left off.
  298.  
  299.             F3 - Special Effects Toggle
  300.  
  301.             Shows may or may not contain special screen transition
  302.             effects.  Most shows created for marketing / display-only
  303.             purposes are likely to contain screen effects.  While
  304.             viewing the show in manual mode, pressing the F3 key toggles
  305.             special effects ON and OFF.  When special effects are
  306.             active, the "FX" indicator will be displayed at the left of
  307.             the help line (if the help line is displayed).  When effects
  308.  
  309.  
  310.  
  311.                                                                  SHOW2 7
  312.  
  313.  
  314.             have been disabled, the "NoFX" indicator is displayed
  315.             instead.
  316.  
  317.  
  318.             First and Last Screens
  319.  
  320.             SHOW2 will chirp if you attempt to move back from the first
  321.             screen, or forward from the last screen -- to let you know
  322.             that you were at the beginning or end of the show --.  The
  323.             current screen will remain displayed.
  324.  
  325.  
  326.             AutoMode Operation
  327.  
  328.             In AutoMode, SHOW2 continuously displays the Shows found in
  329.             the default or specified show directory (with the exception
  330.             of No-Show files, described below).  Prior to starting the
  331.             display, the file names are sorted in ascending alphabetic
  332.             order.  This allows user-specified ordering of the shows,
  333.             merely by renaming the files.  For example, the files
  334.             TEST1.SH2, ZIGGIE.SH2, and NEW1.SH2 would be displayed in
  335.             the following order: NEW1, TUTOR, and ZIGGIE.  To change the
  336.             show order to TUTOR, ZIGGIE, and NEW1, the files should be
  337.             renamed so that the new names are sorted in the desired
  338.             order:
  339.  
  340.             C:>ren TUTOR.SH2 SH2W1.SH2
  341.             C:>ren ZIGGIE.SH2 SHOW2.SH2
  342.             C:>ren NEW1.SH2 SHOW3.SH2
  343.  
  344.             Any file names may be used (however, if the .SH2 file is to
  345.             be later disassembled with the FirstLook Show Director
  346.             program, the file name should not exceed five characters).
  347.  
  348.  
  349.             No-Show Files
  350.  
  351.             Files will be excluded from the AutoMode show if their name
  352.             starts with the "@" character.  Rather than deleting files
  353.             from the show directory, they can be easily renamed to a
  354.             filename starting with the "@" character.  (Note: if there
  355.             is only one file in the show directory it may not have the
  356.             "@" prefix).
  357.  
  358.  
  359.             Starting and Running SHOW2 in AutoMode
  360.  
  361.             To invoke AutoMode operation, the /AUTO parameter must be
  362.             used in the DOS command line used to start the SHOW2
  363.             program.  In addition, the /NOA (no acknowledgment)
  364.             parameter may also be used in conjunction with the /AUTO
  365.  
  366.  
  367.  
  368.                                                                  SHOW2 8
  369.  
  370.  
  371.             parameter to disable the default 4-second show credit screen
  372.             display.
  373.  
  374.             The /NOFX parameter may also be specified to disable special
  375.             effects.  When /NOFX is used, screens are displayed
  376.             instantaneously and remain displayed for the duration
  377.             specified in the .SH2 file.  As mentioned earlier, effects
  378.             and display timing are defined when the show is created and
  379.             cannot be altered by the viewer.
  380.  
  381.             To start SHOW2 in AutoMode without the credit screen
  382.             display, use the following command line:
  383.  
  384.             C:>SHOW2 [other parameters] /AUTO /NOA
  385.  
  386.             No user prompts are displayed while in AutoMode.  At the
  387.             beginning of each show, SHOW2 displays the credit screen for
  388.             4 seconds (unless /NOA is used), then starts displaying show
  389.             screens automatically, using the special effects (unless
  390.             /NOFX is used) and screen timing values defined in the .SH2
  391.             file.
  392.  
  393.  
  394.             AutoMode/Manual Mode Toggle
  395.  
  396.             At any time during the show, pressing <F10> will toggle
  397.             between automatic and manual modes.  When F10 is pressed, an
  398.             information screen will be displayed, stating the program's
  399.             new mode of operation.  Pressing a key will resume operation
  400.             under the new mode.   When in AutoMode, <F10> is the only
  401.             accepted keyboard input.  The <F10> key will not be
  402.             recognized if the program was started in manual mode.
  403.  
  404.  
  405.             AutoMode Batch Operation
  406.  
  407.             AutoMode batch operation allows SHOW2 to start and end
  408.             automatically.  In this mode, the program may be included as
  409.             part of a batch file.
  410.  
  411.             To specify Batch Mode, use the /AUTn parameter rather than
  412.             the /AUTO parameter.  The "n" suffix is a single digit from
  413.             0 to 9 which defines the number of shows to be displayed
  414.             before the program terminates and returns to DOS.  All other
  415.             AutoMode rules apply, but the program will not produce a
  416.             display upon startup.
  417.  
  418.             The /NOA and /NOFX parameters may also be specified.
  419.  
  420.             In Batch Mode, SHOW2 will automatically cycle through all
  421.             eligible .SH2 files until the number of shows displayed
  422.  
  423.  
  424.  
  425.                                                                  SHOW2 9
  426.  
  427.  
  428.             equals the "n" suffix in the /AUTn parameter.  If the show
  429.             directory only contains one file, then that show will be
  430.             displayed n times.  If the show directory contains two files
  431.             and n=3, SHOW2 will display the first show, the second show,
  432.             the first show again, and will terminate.
  433.  
  434.  
  435.             Continuous Unattended Operation
  436.  
  437.             If the /AUTX parameter is used, SHOW2 will start without
  438.             displaying its AutoMode startup prompt, and will run
  439.             indefinitely until the program is switched to manual mode
  440.             via the F10 key.  /AUTX allows SHOW2 to be included in an
  441.             AUTOEXEC.BAT file on a bootable diskette, for example.  As
  442.             with batch mode, /NOA and /NOFX may also be specified.
  443.  
  444.  
  445.             Video Adapter Support
  446.  
  447.             Shows are developed with color displays in mind, but they
  448.             can be viewed on any display.  Since FirstLook allows
  449.             vibrant, high-intensity background colors, a color display
  450.             is strongly recommended.
  451.  
  452.             SHOW2 automatically detects the following display types:
  453.  
  454.                - Color monitors attached to CGA, EGA, VGA , and MCGA
  455.                  adapters.
  456.                - Monochrome monitors attached to MDA, Hercules,
  457.                  EGA, VGA, and MCGA adapters.
  458.  
  459.             When a monochrome monitor is detected, SHOW2 will translate
  460.             all screen colors to provide a readable display.  SHOW2 also
  461.             recognizes the current video mode, which may be used to
  462.             override the installed hardware operation.  When SHOW2
  463.             detects a monochrome display, it will use a default color
  464.             translation method to make the show as "visible" as possible
  465.             on the monitor.
  466.  
  467.             Certain special purpose monochrome monitors may not be
  468.             recognized by SHOW2.  In addition, the default color
  469.             translation method may not yield acceptable results.  If
  470.             this is the case, you should use the /BWx command-line
  471.             parameter when starting SHOW2.  The "x" in "/BWx" in a digit
  472.             from 1 to 5, which selects one of five color translation
  473.             schemes.  Rather than explaining each color translation
  474.             method in detail, you should experiment with parameters /BW1
  475.             through /BW5 to determine which yields the best results on
  476.             your monitor/adapter combination.
  477.  
  478.  
  479.  
  480.                                                                 SHOW2 10
  481.  
  482.  
  483.             For monochrome composite video monitors attached to Color
  484.             Graphic Adapters (CGA), the DOS MODE BW80 command should be
  485.             used prior to starting SHOW2 to insure proper operation.
  486.             Incidentally, this is NOT a peculiar requirement of the
  487.             SHOW2 program.  The MODE BW80 command tells DOS to disable
  488.             the CGA's color burst, which makes displays far more visible
  489.             on composite monochrome monitors.  If your system is so
  490.             equipped, this command should be included in your
  491.             AUTOEXEC.BAT file.
  492.  
  493.  
  494.             Incompatible Video Adapters
  495.  
  496.             All recent major brand video adapters are fully compatible
  497.             with the IBM adapters they are intended to replace.  Certain
  498.             older "Brand X" adapters may not be fully compatible with
  499.             the IBM standards, however.  Specifically, some CGA or MDA
  500.             adapters may not support the high-intensity background
  501.             feature used to SHOW2's advantage (this hardware feature is
  502.             fully documented in the IBM PC Technical Reference manual).
  503.             Lack of compatibility may show as garbage on the screen or,
  504.             in extreme cases, outright system lockup.  Should you
  505.             experience such problems, use the /NH (no high-intensity
  506.             background) parameter in the SHOW2 command line.
  507.             Unfortunately, this lack of compatibility cannot be
  508.             detected.
  509.  
  510.             The SHOW2 program is not responsible for the problem; it
  511.             merely points out your adapter's lack of IBM compatibility.
  512.             To get the problem solved (rather than circumvented), you
  513.             should contact your video adapter's vendor or manufacturer
  514.             and get a fully-compatible replacement.
  515.  
  516.  
  517.             Compatibility with earlier versions
  518.  
  519.             Although very similar to earlier versions of SHOW.EXE
  520.             (distributed with Qmodem 4.x and the John Hancock Tag Line
  521.             Manager program), version 2.0 of the program cannot process
  522.             version 1.x show files (.SHO), and vice-versa.  You may
  523.             safely store .SHO and .SH2 files in the same directory,
  524.             however;  SHOW.EXE and SHOW2.EXE will only recognize files
  525.             which they can process.
  526.  
  527.             DO NOT rename .SH2 file to .SHO or vice-versa;  this will
  528.             guarantee a serious failure of the SHOW or SHOW2 program
  529.             which will translate into screen garbage (at best) or
  530.             complete system lockup (at worst).
  531.  
  532.  
  533.  
  534.                                                                 SHOW2 11
  535.  
  536.  
  537.             SHOW - Version History
  538.  
  539.             Version 2.0
  540.  
  541.             SHOW 2.0 implements a major change in the pointer structure
  542.             of the show files which makes them incompatible with
  543.             previous releases of the SHOW program.  As a result, a pre-
  544.             2.0 version of SHOW.EXE is required to view pre-2.0 shows,
  545.             and version 2.0 will not display pre-2.0 (.SHO) files in its
  546.             show selection window.  The change in file extension to .SH2
  547.             prevents any problems which would result when the SHOW
  548.             program attempts to  process incompatible show files.
  549.             Version 2.0 also implements six new special effects (HBars1,
  550.             VZipDown/Left/Right/Up).
  551.  
  552.             Version 1.7
  553.  
  554.             SHOW 1.7 is a minor upgrade release with one new special
  555.             effect (RollAway).  Although SHOW 1.7 will display show
  556.             files made with pre-1.7 releases of the FirstLook system,
  557.             the addition of this new special effect may cause pre-1.7
  558.             shows special effects not to be displayed accurately (i.e.,
  559.             the screen will be displayed with the wrong effect).  This
  560.             should only cause minor inconveniences.  Version 1.7 of the
  561.             program was never released to the public.
  562.  
  563.             Version 1.6
  564.  
  565.             New in SHOW 1.6 is a choice of color translation methods
  566.             when viewing a color show on a monochrome monitor.  This
  567.             feature is implemented via a change in the /BW command-line
  568.             parameter.
  569.  
  570.             Version 1.5
  571.  
  572.             SHOW release 1.5 can operate in automatic or manual mode,
  573.             and implements user-controlled special effects and display
  574.             timing.  In Automatic Display mode (AutoMode), the program
  575.             cycles through all eligible shows automatically, and each
  576.             screen is displayed for a user-specified duration.
  577.             Automatic Batch mode  can also be used to control the number
  578.             of automatic show iterations.  In batch mode, SHOW will
  579.             terminate and return to DOS once the "Show is Over".  For
  580.             additional details, refer to the section titled "AutoMode
  581.             Operation" found earlier in this document.
  582.  
  583.             Versions 1.0 through 1.4
  584.  
  585.             SHOW releases 1.0 through 1.4 were working versions of the
  586.             program and were never released.